3.1 新增本地组织架构

请求参数

Path: /api/v2/localUserGroup/createGroup

Method: POST

接口描述:

  1. 认证策略ID,authComposeId获取方式,用“开发者工具”过滤请求 authCompose/queryAll,在控制台“业务管理”->“认证管理”->“认证策略”页面中打开您新增用户所属的用户目录,找到所属用户目录的认证策略查询接口,查看响应体数据获取对应的认证策略ID
  2. 用户策略ID,userPolicyId获取方式,用“开发者工具”过滤请求 userPolicy/queryUserPolicy,进入控制台“业务管理”->“策略管理”->“用户策略”页面,查看响应体数据获取所需策略的ID

请求参数

Headers

参数名称 参数值 是否必须 示例 备注
Content-Type application/json 必须  

Body

名称 类型 是否必须 默认值 备注 其他信息
name string 必须 组织架构名字
parentGroupId string 必须 所属组ID,和所属组全路径二选一,都传时已所属组ID为主 可通过组织架构查询接口获取
path string 必须 所属组全路径,和所属组ID二选一,都传时已所属组ID为主 >=2.2.16 开始支持
description string 非必须 描述
roleIdList string[] 非必须 角色ID列表 roleIdList和roleNameList只传一个即可,都传时以roleIdList为准
roleNameList string[] 非必须 角色名列表 roleIdList和roleNameList只传一个即可,都传时以roleIdList为准
userPolicyId string 非必须 用户策略ID 2.2.5开始支持,可以传空字符串代表策略为空,不传视为策略为空
authComposeId string 非必须 认证策略ID 2.2.5开始支持,可以传空字符串代表策略为空,不传视为策略为空

请求示例

{
    "name": "本地分组1",
    "path": "/",
    "roleIdList": [ "7759f620-5583-11eb-880a-913383f106f2", "6559f620-5583-11eb-880a-913383f106f2"],
    "description": "测试分组"
}

返回数据

名称 类型 是否必须 默认值 备注 其他信息
code number 必须 错误码,非0表示失败
data string 必须 本地组织架构ID
msg string 必须 描述信息  

返回示例

{
    "code": 0,
    "data": "18041790-5af9-11eb-a393-bbd9cb0893d1",
    "msg": "请求成功"
}

错误信息

错误提示 错误码
parentGroupId和path参数至少需要传一个 7201
组织架构名称不能包含/字符 7201
组织架构名称长度不能超过128字符 7201
组织架构名(%s)已存在 77200005
所属组不存在 77200005
本地用户组织架构深度数量到达上限32,不允许继续增加 77200005
用户策略不存在 77200004
认证策略不存在 77200004
部分角色数据已经删除,请重新选择 10000001
深信服科技 all right reserved,powered by Gitbook本文档更新于: 2023-12-02 09:36

results matching ""

    No results matching ""